Copyright: Wise Copyright ® 1994 GLBS, Inc.


Contents
Wise Installation System

Introduction

The Wise Installation System creates and edits Windows Self-Installing Executables.  It uses an installation script to determine which files to install and where the files are copied to.  The resulting executables can be directly uploaded to a BBS or other On-Line service.  The end-user does not need any software (other than Windows itself) to install the Wise executable.  When they run the program under Windows, the program extracts the files from itself and installs them onto the client system.

 Overview

 Commands

 Script Items

 Installation Topics

 Reference


Contents
Wise Installation System

Introduction

The Wise Installation System creates and edits Windows Self-Installing Executables.  It uses an installation script to determine which files to install and where the files are copied to.  The resulting executables can be directly uploaded to a BBS or other On-Line service.  The end-user does not need any software (other than Windows itself) to install the Wise executable.  When they run the program under Windows, the program extracts the files from itself and installs them onto the client system.

 Overview

 Wise Installation System Overview

 Creating Your First Installation

 Editing the Installation Script

 Installation Executable Options

 Variables

 Commands

 Script Items

 Installation Topics

 Reference


Contents
Wise Installation System

Introduction

The Wise Installation System creates and edits Windows Self-Installing Executables.  It uses an installation script to determine which files to install and where the files are copied to.  The resulting executables can be directly uploaded to a BBS or other On-Line service.  The end-user does not need any software (other than Windows itself) to install the Wise executable.  When they run the program under Windows, the program extracts the files from itself and installs them onto the client system.

 Overview

 Commands

 Using the Script Assistant

 Setting Installation Properties

 Creating an Installation

 Testing an Installation

 Running an Installation

 Copying an Installation to Floppy Disks

 Changing Source Directories

 Script Items

 Installation Topics

 Reference


Contents
Wise Installation System

Introduction

The Wise Installation System creates and edits Windows Self-Installing Executables.  It uses an installation script to determine which files to install and where the files are copied to.  The resulting executables can be directly uploaded to a BBS or other On-Line service.  The end-user does not need any software (other than Windows itself) to install the Wise executable.  When they run the program under Windows, the program extracts the files from itself and installs them onto the client system.

 Overview

 Commands

 Script Items

 Install File(s)

 Copy Local File(s)

 Prompt for Text

 Display Message

 End Block

 Add ProgMan Icons

 Edit INI File

 Display Graphic

 Execute Program

 Call DLL Function

 Edit Registry

 Delete File(s)

 If Statement

 Else Statement

 Remark

 Custom Dialog

 Get System Information

 Get Temporary Filename

 Create Directory

 Exit Installation

 Add Directory to Path

 Add to AUTOEXEC.BAT

 Add to CONFIG.SYS

 Add to SYSTEM.INI

 Get Directory with Browse

 Get Components

 Display Readme File

 Get ProgMan Group

 Read INI Value

 Read Registry Key

 Add Font to Windows

 Win32 System Directory

 Check System Capabilities

 Search for File

 Get Name/Serial Number

 Write Variable to File

 Set Variable

 Get Environment Variable

 Radio Button Dialog

 Check If File Exists

 Set File Attributes

 Set Files/Buffers

 Play Wave File

 Find File in Path

 Check Disk Space

 Installation Topics

 Reference


Contents
Wise Installation System

Introduction

The Wise Installation System creates and edits Windows Self-Installing Executables.  It uses an installation script to determine which files to install and where the files are copied to.  The resulting executables can be directly uploaded to a BBS or other On-Line service.  The end-user does not need any software (other than Windows itself) to install the Wise executable.  When they run the program under Windows, the program extracts the files from itself and installs them onto the client system.

 Overview

 Commands

 Script Items

 Installation Topics

 Adding Support for SHARE

 Adding Uninstall support

 Controlling the Install via DDE

 Sample Wise Installation Script

 File In Use Errors

 Version Checking

 Long Filename Support

 Reference


Contents
Wise Installation System

Introduction

The Wise Installation System creates and edits Windows Self-Installing Executables.  It uses an installation script to determine which files to install and where the files are copied to.  The resulting executables can be directly uploaded to a BBS or other On-Line service.  The end-user does not need any software (other than Windows itself) to install the Wise executable.  When they run the program under Windows, the program extracts the files from itself and installs them onto the client system.

 Overview

 Commands

 Script Items

 Installation Topics

 Reference

 Whats New!

 Ordering Information

 Technical Support

 Copyright/License/Warranty

 Known Problems/Restrictions


Overview

The Wise Installation System makes it easier for you to distribute your programs, and easier for your clients to install those programs.  The Wise Installation System also supports splitting your installation file across multiple disks (in the Professional version).  You can split the installation executable up to make downloading from a BBS easier.  With other installation systems you must do the following to install a software package downloaded from an On-Line service:

•	Find the correct "Dearchive" program if the file is not a self-extracting DOS program

•	Create a temporary directory

•	Execute the self-extracting program or run the "Dearchive" program with the proper command line arguments

•	Switch back to windows and execute the Windows Setup program

•	Delete the temporary directory if the installation was successful

On the other hand, when you install a Wise executable you need to do the following:

•	Double-Click the installation programs name in the File Manager

Wise Features

Installation Log

Variables

Installation Process

Installation Executable Options


Wise Features

The Wise Installation System gives you great flexibilty in creating professional quality installation programs.  It supports the following features in the Professional Version:

•	Single File, self-installing, Windows executable

•	Bitmap graphics, both transparent and opaque displayed during the installation

•	Multiple prompts for file locations

•	Subsets of the files can be loaded

•	Very low installation program overhead

•	Very high compression ratios

•	Executing external programs

•	Version Checking

•	Disk space checking

•	Installation Log

•	Making backup copies of replaced files

•	Adding keys to the registration database

•	Checking DLL/VBX dependencies

•	Multiple Disk Installations

•	Calls to DLL based functions

•	Customizing the installation with Visual Basic programs

•	A free distributable uninstaller

•	Support for multiple languages in a single installation script

•	Editing the AUTOEXEC.BAT/CONFIG.SYS/SYSTEM.INI

•	Component based installations

•	Searching for a file on the destination system

•	Radio button dialogs

•	Reading the values of Envronment Variables, INI entries, and Registration Database keys into script variables.

The Developers Version of Wise has all of the features of the Professional Version as well as:

•	Custom Dialog Editor

•	256 Color Bitmap Support

•	Long filename support under Windows NT and Window 95

•	Password Protected Installations


Installation Log

A log is created during the installation that describes the changes that were made to the destination system.  It lists the files that were copied, the icons that were added, and the INI files that were edited.

The installation log is called INSTALL.LOG and it is placed in the same directory as the first file that you copy to the destination system.  You should make sure that your first file is copied into your main application directory.


Variables

The use of variables is fundamental to the creation of an installation script.  Variables hold the pathnames of where your files will be copied.  They can also be used to hold the names of groups you will add to the Program Manager.  Variables can be created by a Prompt script item or in a DLL function call.  When referencing a variable, you must enclose it in percent (%) signs.  There are four pre-defined variables:

1 	WIN:  This variable holds the pathname to the Window directory (usually C:\WINDOWS).

2 	SYS:  The Windows System directory pathname is contained in this variable (usually C:\WINDOWS\SYSTEM).

3 	TEMP:  This varible holds the directory where temporary files may be placed.  This variable is useful for placing DLLs before you call their functions.

4 	INST:  The pathname of the location of the installation executable is held in this variable.  This can be useful if you want to display a readme.txt that is located on the same disk as the installation executable.

5 	RESTART: When this variable is set to 'W' Windows will be restarted at the end of the installation.  If the variable is set to 'S' the system will be rebooted.  A number of advanced script items (editing autoexec/config) set this variable.

6 	BACKUPDIR: If this variable is set, all files replaced by the installation will be placed into this directory.

7 	PASSWORD: If your installation is password protected this variable will be used as the password. If this variable is not set, the user will be prompted to enter the password.

In addition to the four pre-defined variables, there is a special variable that you may choose to place in a Prompt script item.  If you create the variable BACKUPDIR, all files replaced by the installation will be placed into that directory.  If you need to place a percent sign into your script, you must place two percent signs next to each other as in:

   There is a 100%% chance this will work!

When the installation executable is run, this will display as:

   There is a 100% chance this will work!


Installation Process

There is a two step process in the installation.  First you (the programmer) use Wise to create an installation script.  After you have created the installation script, you press the Create button to copy all of the files into an installation executable.  You can then upload this executable to a BBS or place it on a floppy.

Your client (the installer) then receives the installation executable from you either via modem or floppy.  They run the installation executable under Windows (either via Program Manager File->Run or File Manager double-click).  The installation executable then extracts the files from itself and copies them onto the client's computer.

The following graphic describes the installation process:


Executable Options
Installation Executable Options

The executable files that are created have command line options that can be used to test the installation script and to install software manually.

Test Mode

When you run the Wise executable with the /T command line option, the installation script will be tested.  Although the installation will look the same, no changes to your system will be made.  No files will be copied and no INI or Program Manager changes will be made.  This mode is useful when testing an installation script before it is distributed.

Manual Mode

The /M option runs the installation in manual mode.  You will be prompted for the locations of your Windows, System, and Temp directories.  You can specify any directories, if they do not exist they will be created.  Any changes to INI files will be saved into the Windows directory you specify.  With this option you can have the installation run without installing any files into your real Windows and System directory.  You can then manually copy the files to their proper destination.

Extract Mode

The /X command line option allows you to extract single files from the installation executable.  The files that are contained in the Wise executable will be listed along with the file dates and sizes.  You can then select a file and choose the directory to place the file into.  If you follow the /X option with a pathname, all of the files in the installation executable will be placed into that directory.  If the directory does not exist, it will be created.  The /Z command line option acts exactly like to /X option except Windows will be exited after the files are extracted.  This can be useful for BBS operators that want to perform virus scanning on all of the files in the Wise executable.


Getting Started

This section describes the basic steps you must take to create an installation script using the Wise Installation System.  You may press the F1 button at any time to receive context sensitive help on the current operation.

To create a basic installation script perform the following steps:

•	Select the New item from the File Menu.  (You may have to save the previous script if you have changed it)

•	Enter a title (for example: My Test Installation) into the Title field.

•	Enter the default directory the user will be prompted with in the Default Dir field.  Press the OK button.

•	Change the directory in the directory list box to where your software files are located.  Select the files to install by selecting then in the File Name box and pressing the Add File button.  Press the OK button when done.

•	Enter the default Program Manager group name of your software into the Default Group Name field.  Select any files that you want icons added for in the files list.  Press the OK Button.

NOTE:  You can add blank lines into message text by pressing the Ctrl-Enter key.


Editing Installation Script
Editing the Installation Script

When you first run the Wise Installation System, you will see the following screen.  This screen shows you everything about the installation executable that you will create.  You can press on parts of the screen below for a description of their function:


PreScriptAssist
Create New Installation Script

You start the Script Assistant by selecting the New item from the File menu. The following dialog is displayed and will lead you through the process of creating a new installation script.  You can press the Cancel button to start with a blank installation script.  Press the parts of the dialog below to get help on the individual fields. You can press the F1 key on any of the dialog boxes to receive context sensitive help on that dialog.


Preferences

This property sheet contains the preferences of your installation script. To get more detailed information on the options, click on the dialog below.


Create
Create Executable

When you press this button, a Windows Self-installating Executable will be generated from the script that you have entered.  It will have the same name as your script file but have the EXE extension.


Test
Test Executable

Press this button to test your installation script.  In this the test mode, no changes will be made to your computer system.


Run
Run Executable

This button will run the installation executable and install the software on your system.  It runs the installation in manual mode.  You will be prompted for where you want the Windows, System, and Temp directories to be placed.


MakeDisk
Make Floppy Disks Button

This button will copy the installation executable file to a floppy.  If you have split your installation executable, you will be prompted for a new floppy for each file.

NOTICE:  This feature is availiable in the Profession Version only.


Changing Source Directories

If the directories that contain the files in your installation change, you can use this dialog to modify the source directories for your installation script. To change a source directory select the source directory from the list and modify its value in the editbox. If the Change Sub-Directories box is checked all of the directories below that directory will also be changed. You can access this command from the Source Directory item in the Edit menu.


File

This item will copy a single file into the installation executable.  During installation, the file will be copied into the destination directory.  The destination directory must begin with a variable name.


Local File Copy

The local file copy script item can be used to copy files that are not inside of the installation executable. You should use this script item to copy a license or serial number file from the installation floppy to the users hard disk. You can also use this option to copy files from a CD-ROM to the hard disk.


Prompt
Prompt for Text

This script item will prompt the installer for information.  This is usually a directory name where they would like to install your program.  It can also be a group name of a Program Manager group to add your icons to.  If you choose, you can have a default value already filled in the prompt to make your installation easier.


Message
Message/Message Block

The message item will display a message on the screen.  It can also be used to ask the installer a Yes/No question.  When you select the Start Block checkbox a Yes/No dialog will be displayed.  If the user answers "No" then none of the script lines will executed until the matching End Message Block is reached.


EndBlock
End Message Block

This script item ends a message or a DLL block.  These blocks are used to determine which items in the script will be executed.  You must have one End Message Block for each Message Block or DLL Block.


ProgMan
Program Manager Icons

You can add this item to your script to add and delete icons from the Windows Program Manager.  Click on the picture below for more information about the information you must provide.

NOTE: Not all Program Manager replacement shells allow parentheses "( )" and commas "," in the icon name. You should avoid using these characters in your icon names.


INI
INI File

This script item should be used to add, delete, and modify the values in various Windows INI files.

NOTE: You should NOT use this script item to edit device entries in the SYSTEM.INI file!  This should be used to edit the WIN.INI or your private INI files only.


Graphic

You can add bitmap graphics to the installation screen that are displayed during the installation process.  The file type of the graphic files you use should be BMP.  A transparent graphic will make any solid blue color (Red=0, Green=0, Blue=255) in the graphic transparent as it is being displayed.


Execute
Execute Program

This script item can be used to execute a Windows or DOS program.  You should enter the pathname on the destination system and the command line.

NOTE:  If you do not check the Wait for Program to Exit checkbox, you should only use this at the end of your installation script.


DLL
Call DLL Function

You use this script item to call a function in a DLL library.  The DLL function must be declared as specified in the Professional version documentation.  You should copy the DLL to the TEMP directory before you call the DLL function.  If you copy the DLL file to any directory other than the TEMP directory, you will not be able to run the installation script in test mode.

NOTICE:  This function only works in the Wise Installation System Professional version.  Please refer to the registration screen for more information.  For additional information, please refer to the Professional version's documentation.


Registry
Registration Database

You can add keys to the registration database by using this script item.  This can be used to register document types and DDE/OLE with the shell.

NOTICE:  This feature is enabled in the registered versions of the Wise Installation System.


Delete File

This script item will delete a file on the destination system.


IfBlock
If Statement

The if statement can be used to check the contents of a variable and branch depending on the value.


Exit Installation

This installation script item will cause the installation to be exited.


Remark

The remark script item can be used to place comments into your installation script.


Custom Dialog

The custom dialog editor creates and edits dialog sets. These dialog sets display and gather information from the user during the installation. Please refer to the Wise Users Guide for more information on the custom dialog editor.


Get System Information

This script item will retrieve information into a variable. The following information can be gathered.

•	Current Date/Time

•	Windows Version

•	DOS Version

•	K Bytes of Available Memory: this is the amount of free space when the installation is running, not the amount of physical memory in the computer.

•	File Date Time Modified: The Pathname field holds the name of the file to return the information on.

•	File Version Number: This return the version number of a EXE/DLL that contains a version resource. If the file specified in the Pathname field does not contain a version resource the returned value will be empty.

•	Registered Owner Name: Returns the value entered by the user in the user name field when Windows was first installed. This is a useful default value for the Get Name/Serial Number dialog.

•	Registered Company Name: Returns the value entered by the user in the company name field when Windows was first installed. This is a useful default value for the Get Name/Serial Number dialog


Get Temporary Filename

This script item creates a temporary file in the %TEMP% directory and places the filename into the variable. All temporary files are automatically removed when the installation is completed. This script item is useful for creating temporary files (DLLs, help files) that are used only during the installation. Since this script item returns only a filename, you must reference the temporary file with the %TEMP%\ prefix.  For example, if you retrieve a temporary filename into the variable HELPFILE the full pathname of the file is %TEMP%\%HELPFILE%.


Create Directory

This installation script will create an empty directory on the destination computer. If the directory already exists, no action is taken.


Add Directory to Path

You can add a directory to the PATH environment variable with this script item.  A backup copy of the AUTOEXEC.BAT will be made. (AUTOEXEC.001)  If the directory is already in the path, it will not be re-added.


Add Command to Autoexec.bat

This script item will add a command to the AUTOEXEC.BAT file.  If the command already exists (it must match the added command exactly), it will not be re-added.  A backup file AUTOEXEC.001 is created.


Add Command to Config.sys

You can add commands to the CONFIG.SYS file using this script item.  A backup file (CONFIG.001) will be created.  If the command already exists in the CONFIG.SYS, it will not be re-added.


Add Entry to System.ini

This script item will add an entry to the [386Enh] section of the SYSTEM.INI file.  A backup file (SYSTEM.001) will be created if changes are made.  You should enter the full name of the line to add (i.e. device=vshare.386).  If the line already exists, it will not be re-added.


Browse Directory
Browse Directory Tree Prompt

This script item will get a pathname into a variable.  The dialog will display the directory tree and allow the user to select the drive and pathname to install to.  If you place a full treename into the default, it will be the default directory.  If you do not enter a full pathname, the root will be the current directory.


Components Dialog
Install Components Dialog

This script item will allow you to prompt the user for the components of your software they would like to install.  The destination variable will be filled with a list of the letters of the components that the user chooses.  You should use the If variable Contains script item to copy the proper files.

To have some of the checkboxes initially checked when the dialog is displayed use the Set Variable script item to set the value of the components variable to the letters that correspond to the boxes you want checked.  For example, if you want the first and third checkboxes initially selected you use the script item:

     Set Variable COMPONENTS to AC

You must use uppercase letters in the set variable script item and the script item must preceed the components dialog script item.


Display Read Me Dialog

You can display a text file into a dialog box with this script item.  The file must contain only text characters and be 30K or smaller in size.


Browse Group
Browse Program Manager Groups

This script item will display a dialog that lists the existing Program Manager groups and allows the user to select one.


Get INI Entry Value

This script item reads the value from a INI file into a variable.


Read Registry Key
Read Registration Database Key

This script item will read the value of a Registration Database Key into a variable.  If the key does not exist, the default value will be returned.


Add Font to System

This script item will add a font to your system.  You must not specify a full pathname.  The font file must have already been copied into the Windows System directory.


Get Win32 System Directory

The system directory pathname will be placed into the variable.


Check System Capabilities

You can add this script item to check the capabilities of the system your software is being install on.


Search for File

This script item will scan the users disk drives for the file name given.  No wildcard character may be used.  If the file is not found, the default value is returned.


Serial Number Dialog
Name/Company/Serial Number Dialog

A dialog will be displayed that prompts for the users name, company, and the serial number of the product that is being installed.  The values that are entered are returned into variables.


Write Variable into File

This script item will write the value of a variable into a binary file at the specified location.  This can be useful for place a serial number into your EXE files.


Set Variable
Set Variable Value

This script item can be used to set the value of a variable.  A number of operations can be performed on the variable as it is being set.


Get Environment Variable

You can read the value of an environment variable into a installation variable with this script item.


Radio Button Dialog

This script item will display a dialog with a list of radio buttons.  The letter that corresponds to the button the user selected will be returned in the destination variable.

To have a radio button other than the first initially selected use the Set Variable script item to set the value of the destination variable to the letter that correspond to the radio button you want selected.  For example, if you want the second initially selected you use the script item:

     Set Variable COMPONENTS to B

You must use uppercase letters in the set variable script item and the script item must preceed the radio button dialog script item.


Check If File Exists

This advanced script item can be used to determine if a certain file exists on the destination computer system.  This can be useful in network installations or when detecting previous versions of software.


Set File Attributes

This script item can be used to modify the file attributes for one or many files.


Set Minimum Files and Buffers
Set Minimum Files/Buffers

This script item edits the CONFIG.SYS file and changes the "Files=" or "Buffers=" settings if they are below the values indicated.


Play Wave File

This script item will load the specified WAV file into memory and play it. The Wave Pathname field should hold the full pathname of the WAV file. There must be enough memory to load the entire WAV file into memory to play it. The Loop continuously checkbox can be used to cause the WAV file to be played over and over. You can turn off playing of a WAV file by setting the Wave Pathname field to blank.


Find File in Path

This script item will search all of the directories in the PATH environment variable for the file specified.


Check Free Disk Space

This script item should be used to check that enough free space is available on the destination computer for the installation to succeed.  You can also indicate how much free space should be on the disks after the installation finishes.


Adding Support for SHARE

File sharing capabilities are required by many programs. There are two ways of adding support for SHARE to Windows: 1) via the DOS SHARE.EXE program and 2) via the Windows VSHARE.386 file. It is recommended that the Window VSHARE.386 method be used to add support for SHARE. A copy of VSHARE.386 is included with Wise in the ADVANCED sub-directory. The following steps are required to add support for SHARE:

1 	Check if SHARE is already running (use the Check System Capabilities script item), if it is skip the following steps.

2 	Check if the VSHARE.386 file is already in the %SYS% directory. If it is not, install the VSHARE.386 file to %SYS%. (use the Check If File Exists script item and the Install File(s) script item).

3 	Add the line device=vshare.386 to the SYSTEM.INI file. (use the Add Device to SYSTEM.INI file)

The Script Assistant has a checkbox (Support File Sharing via SHARE) that will add the appropriate script items to your installation script.


Adding Uninstall Support

The Wise Uninstall program (UnWise.EXE) is located in the same directory as the Wise program.  You can freely distribute this program in your installation executables.  This program reads the INSTALL.LOG file and uninstalls the program/data files that were installed.  To add an uninstall option to your installations:

1 	Copy the UnWise.EXE file from the Wise directory to the Windows directory on the destination system.

2 	Create an icon with the command name of %WIN%\UNWISE.EXE and a parameter of your installation directory and the INSTALL.LOG name as in: %WISE%\INSTALL.LOG

3 	You can add an optional second command line parameter to the UNWISE command line, the title of the window displayed during the installation. You should place the title in double quotes.


Controlling the Install via DDE

The programs that are executed via the Execute script item can establish a DDE link to the installation program using the program name WiseInst.  The programs can then do one of the following:

•	Send a DDE request with a topic name of the name of a variable to read.  The value returned is the variable value. The item name is not used.

•	Execute a DDE command with a topic name of a variable to set/create.  The command string should contain the value of the variable. The item name is not used.

•	Execute a DDE command with a topic name of Cancel.  This will cause the installation to be aborted.

The example program VBDDE in the DDE subdirectory demonstrates using a DDE link to read and set run time installation variables.


Sample
Sample Wise Installation Script

In the SAMPLE subdirectory below the WISE main directory there is a sample installation script.  This is the same installation script that installed Wise onto your system.  Included in this directory are the two bitmap graphics that were used during the installation.

The pathnames in this sample installation script assume that you installed the Wise Installation System into the directory C:\WISE.  If you get "cannot find file" errors, edit the source pathnames to point to the directories where you installed Wise.


File In Use Errors

During the installation you may receive File In Use with the options to Abort, Retry, or Ignore. This indicates that the file you attempted to install is currently being used by another program and cannot be updated. Normally the user should exit all other applications are press the Retry button to continue the installation.

There are some files that are almost always in use by Windows and should not normally be placed into your installation. These files are included in the standard Windows 3.1 installation and do not need to be re-installed: COMMDLG.DLL, DDEML.DLL, and VER.DLL

In addition, the CTL3D.DLL or CTL3DV2.DLL files may be used by the installation, if your install updates these files you must check the Use Internal 3D Effects checkbox in the Global Properties dialog.


Version Checking

Wise uses the VerFindFile and VerInstallFile routines to perform version checking on installed files. If you install a shared DLL/VBX to the Windows or System directory these routines will normally move a file from the Windows directory into the System directory on a non-network Windows installation. In a networked environment the shared DLL/VBX will be placed into the Windows directory.

If an existing file has the exact same version number as the file to be installed it is still replaced. This is done to ensure a proper installation. If the existing file has become corrupted and it is not re-installed your software would not function properly.


Long Filename Support

The Windows NT and Window 95 operating systems support filenames longer than the DOS standard 8.3 filenames. The installations created by the Wise Developers version can support long filenames under this operating systems. You enable long file filenames by checking the Support Long Filenames box in the global properties dialog. There are a number of compatibility issues that must be considered when using long filenames:

•	Some program do not support long filenames, you should convert any long filenames to short filenames (via the Set Variable script item) before writing your long filenames to INI files, the Registry.

•	The Windows NT Program Manager does not support long filenames when adding icons. You should convert your filenames to short filenames before adding icons to the Program Manager.

•	You can use long filenames in your installation even if your program does not support long filenames. Make sure you convert any references to your program directory before writing them to your applications INI file.


Whats New

The following features have been added to Wise version 3.0:

•	You add new script items to your installation script by dragging them from the actions list to the installation script directly.

•	A custom dialog editor has been added to the Developers Version of Wise. This allows you to create custom dialogs without programming that include buttons, checkboxes, radio buttons, graphics, and text fields.

•	The speed of the create process has been improved.

•	Support has been added for looping within the installation script.

•	Support has been added for wildcard local file copies.

•	The Developers Version of Wise support 256 color bitmaps and 256 color gradient background colors.

•	Support has been added for long filenames under Windows NT and Windows 95 in the Developers Version

•	The Exit Installation script item has been added.

•	A create directory script item has been added.

•	The Get System Information script item can get information on the system and files (version number, date time modified) and place them into a variable.

•	The If Statement support numeric, date, and version based comparisons.

•	You can now increment and decrement numeric variables.

•	The Create Temporary Filename script item has been added. All temporary files are automatically deleted when the script is exited.

•	Support has been added for a graphic to "Fade In" as it is being displayed.


Ordering Information

Wise Installation System Order Form/Invoice

Ordering by phone:  You can place orders with Visa, MasterCard, or American Express by calling toll free 1-800-554-8565 (International callers: 419-433-4777) or by faxing this order form to 419-433-5050.

Ordering by mail:  To order by mail send this order form and either 1) a personal or cashiers check or 2) a Visa, MasterCard, or American Express credit card number to:

          Great Lakes Business Solutions, Inc.
          39905 Lotzford, Suite 200
          Canton, Michigan  48187

Payments must be in US dollars drawn on a US bank, or you can send international postal money orders in US dollars.

Any questions about the status of the shipment of the order, refunds, order options, product details, technical support, volume discounts, dealer pricing, site licenses, etc, should be directed to 313-981-4970.

Professional Version:  The Professional Version includes hard copy documentation and additional sample installation scripts.

Developers Version:  The Developers Version of the Wise Installation System includes all of the features of the Professional Version as well as support for the custom dialog editor, 256 color bitmaps, long filename support under Windows NT/95, and password protected installations.

Maintenance Contract: The Wise Installation System is updated regularly to include features for new operating systems and to enhance the product. The maintenance contract provides one year of upgrades that will be sent immediately upon the shipment of a new version of Wise. In addition, the maintenance contract entitles the user to telephone based technical support past the initial 30 day period.

Order Form


Order Form

Print Order Form

Wise Installation System Professional Version 3.0:
                     _____  copies at $129 each = ______
Wise Installation System Developers Version 3.0:
                     _____  copies at $179 each = ______
Upgrade from Professional 3.0 to Developers 3.0:
                     _____  copies at  $50 each = ______
Upgrade from Professional Version 2.x to Version 3.0:
                     _____  copies at  $50 each = ______
Upgrade from Professional 2.x to Develepers Version:
                     _____  copies at  $80 each = ______
One Year Maintenance Contract:
                     _____   copies at $95 each = ______
Michigan residents add 6% sales tax             + ______

Shipping (you MUST choose one of the following):
                         UPS Ground for U.S.  $5  ______
                     UPS Second Day for U.S. $10  ______
                       UPS Next Day for U.S. $15  ______
                      International Air Mail  $8  ______
       International Express Mail (3-5 days) $22  ______
                   UPS International Express $40  ______

Additional Download Requests:
        E-Mail via Compuserve add additional $10  ______
Request BBS password to download file (Free)  $0  ______

                                   Total payment  ______

            Name: ______________________ Date:___________

         Company: _______________________________________

         Address: _______________________________________

City, State, Zip: _______________________________________

         Country: _______________________________________

       Day Phone: ________________ Eve:__________________

      Fax Number: ________________

   Credit Card Type: ( ) Visa  ( ) MasterCard  ( ) Amex

   Credit Card #: _______________________ Exp Date:______

Cardholder Signature: ___________________________________

Electronic Mail address: ________________________________

How did you hear about the Wise Installation System?
_________________________________________________________

Comments:


Technical Support

Free technical support for Wise is available via the following:

•	Compuserve e-mail: 75111,606

•	American OnLine e-mail: GLBSInc

•	Internet e-mail: 75111.606@compuserve.com

•	Technical Support Fax: 313-981-9746

In addition, 30 days of free technical support via telephone is provided after the purchase of the Wise Installation System. You may purchase a maintance contract to receive automatic upgrades to Wise and technical support via telephone. You may call 800-554-8565 or 313-981-4970 to order the maintenance contract.

•	Technical Support Phone: 313-981-4970


License and Warranty
Copyright/License/Warranty

Wise Copyright © 1994 by Great Lakes Business Solutions, Inc.
All rights reserved.

License Agreement

You should carefully read the following terms and conditions before using this software.

Developers Demo Version

You are hereby licensed to:  use the Developers Demo version of the software for a 30 day evaluation period; make as many copies of the Developers Demo version of this software and documentation as you wish; give exact copies of the original Demo version to anyone; and distribute the Demo version of the software and documentation in its unmodified form via electronic means.  There is no charge for any of the above.

You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission.

Unregistered use of the Wise Installation System after the 30-day evaluation period is in violation of federal copyright laws.

License and Royalties

One registered copy of the Wise Installation System may either be used by a single person who uses the software personally on one or more computers, or installed on a single workstation used nonsimultaneously by multiple people, but not both.

You may access the Wise Installation System through a network, provided that you have obtained individual licenses for the software covering all workstations that will access the software through the network.

You may redistribute the installation programs created by the Wise Installation System freely and without royalties to Great Lakes Business Solutions Inc. In addition, you may freely redistribute the UNWISE.EXE program with those installation programs created by the Wise Installation System.

Governing Law

This agreement shall be governed by the laws of the State of Michigan.

Disclaimer of Warranty

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  Because of the various hardware and software environments into which Wise may be put, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.

Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it.  The user must assume the entire risk of using the program.  ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.

Windows®, Window NT®, and Windows 95® are a registered trademarks of Microsoft Corporation.


Restrictions
Known Problems/Restrictions

Any complex program such as the Wise Installation System will have "Features" which are more commonly referred to as bugs.  Even though this program has been tested thoroughly,  please test any installation executables before distributing them.  If you find a bug in Wise please send e-mail describing the problem to:

          Compuserve:         75111,606
          America On-Line:  GLBSInc

The following is a list of know problems or restrictions with this version of Wise:

•	The demo version creates installation executables that can only be used on the computer that created them.

•	Windows 3.1 is supported only (Windows 3.0 would make the installation program larger since it would have to include copies of VER.DLL, DDEML.DLL, LZEXPAND.DLL)

•	The graphics import supports only Windows Paintbrush BMP file format.  If you have problems importing graphics from other packages, load and re-save the file from Paintbrush.

•	The background pattern is slightly distorted when run using an ATI Graphic Ultra video controller using version 2.1 of the drivers.  This appears to be a problem in the driver dithering code.

•	Calling DLL functions is supported only thru the Professional version of the Wise Installation System.


Topic1
Add Item

You should select this button to add a new Icon to the Windows Program Manager.  You will have to fill in the Group Name, Item Name, and Command Line to the right.


AddToEnd
Add Command To End of File

Normally the command will be placed at the start of the file. Checking this box will cause the command to be appended to the end of the file.


AdvAbort
Abort Installation

If this button is checked, the installation will be aborted after the message is displayed.


AdvAppend
Append

Check this button to append the value to any existing value of the variable.


AdvBlock
Start Block

If this button is checked, a new block will be started if the given check is true.


AdvCheckDescr
Description

This fields holds the text of the message that will be displayed if the check is true.


AdvCheckType
System Check

This list holds the possible items that can be checked on the destination system.


AdvCommand
Command

This field holds the command that will be added to the file.  You should use full pathnames when referencing files.


AdvCompList
Component List

This field holds the list of components, one per line, that will be installed.  For each component you list, you should add a If script item that checks for a letter (A-J) to be contained in the destination variable.


AdvCompVar
Destination Variable

This variable will receive a list of letters that correspond to the selections made by the user.  If the user selects the first component, the letter 'A' will be added to this variable.  You should use the If-Contains script item to create a block that copies all of the files the each of the components.


AdvDefault
Default Value

This field holds the default value of the dialog box.


AdvDescription
Description

This text will be displayed in the dialog box.  It should explain the actions that the user to perform to fill out the dialog box.


AdvDeviceName
Device Name

This field holds the command that will be added to the [386Enh] section of the SYSTEM.INI file.  This command normally starts with the device= prefix.


AdvDirectory
Directory Name

This field holds the name of the directory to add to the PATH environment variable in the AUTOEXEC.BAT file.


AdvDiskVar
Disk Variable

You should place the name of the variable that holds the pathname where your software will be installed.  The free space on the drive that holds that directory will be used in the display of the free space left.


AdvEnvVariable
Environment Variable Name

This field holds the name of the environment variable to read.


AdvFileOffset
File Offset

This is the number of bytes (starting at 0) from the beginning of the file to write the data to.


AdvFontDescr
Font Name

This field holds the full name of the font. This name will be added to the Fonts section of the WIN.INI file.


AdvFontName
Font Filename

You should enter the file name of the font file (TTF or FON) that you want to add to Windows.  The file must have been already copied to the System directory.


AdvHas
Compare Type

This field selects the type of comparison that is done.  You should select whether the system should or should not have the selected feature for the action to be performed.


AdvINIItem
INI Item Name

This holds the INI entry name to be read from.


AdvINIPath
INI Pathname

This field holds the pathname of the INI file to read.


AdvINISection
INI Section Name

This field holds the name of the INI file section (without the []'s) to read.


AdvItems
Advanced Script Items

This list contains a list of advanced script items that you can add to your installation script.  Select an item from this list and press the OK button.


AdvMsgOnly
Display Message Only

If this button is selected only the message will be displayed if the system meets the selected criteria.


AdvOperation
Variable Operation

As the variable is being set the following operations may be performed on it:

•	Increment: add one to a numeric variable

•	Decrement: subtraction one from a numeric variable

•	Remove trailing blackslashes: format a variable to be a valid directory name by removing any trailing backslashes

•	Convert to Long Filename: converts an existing pathname to a long filename. If you are not running under Windows NT or Windows 95 this operation keeps the pathname unchanged.

•	Convert to Short Filename: converts an existing long pathname to it short alias pathname. If you are not running under Windows NT or Windows 95 the pathname will remain unchanged.


AdvPrompt
Prompt Name

This is a short description of the information that the user should enter.  This will be displayed directly below the window title.


AdvRadioList
Radio Button List

This list holds the labels for the radio buttons, one per line, that will be displayed.  The destination variable will contain a single letter (A thru J) representing the radio button that was selected.


AdvReadMePath
Read Me Pathname

This field holds the pathname on the destination system that holds the text to be displayed in the readme dialog box.


AdvRegKey
Registration Database Key

This field holds the registration database key that will be read.


AdvRemove
Remove Filename

By checking this box, any filename that is at the end of the pathname will be removed.  For example, if the variable has the value C:\WISE\WISE.EXE the new pathname would be C:\WISE.  NOTE: The default value will not have any file names removed.


AdvSearchDescr
Description

This text will be displayed on the screen while the search is taking place.


AdvSearchFile
Search Filename

You enter the name of the file that you want to search for into this field.  No wildcard characters are allowed (*, ?).


AdvSerialComp
Company Name

This field will be displayed next to the edit box that will hold the company name entered by the user.


AdvSerialName
Name Prompt

This field holds a short description that will appear next to the field where the name will be entered.


AdvSerialNum
Serial Number

This field holds a short description of the serial number field.


AdvSetValue
New Variable Value

This field holds the new value of the variable.


AdvVariable
Variable Name

This field holds the name of the variable that will receive the results.


AdvWindowName
Window Title

This field holds the title of the dialog box that will be displayed.  This field must be filled in for each language that your script uses.


AdvWritePath
Write File Pathname

This field holds the pathname for the file that you will writing to.  The file must already exist and must contain space for the variables data.


AdvWriteVar
Write Variable

This variable will be written to the binary file.


AttribArchive
Archive

This checkbox will set the archive bit for the selected files.  The archive bit is used by many backup programs to determine which files are backed up in an incremental backup.


AttribHidden
Hidden

Checking this box will make all of the selected files hidden.


AttribName
File Pathname

This field contains the filename or wildcard pathname of the files to change.


AttribRead
Read-Only

Checking this box will make all of the selected files read-only.


AttribScan
Scan Sub-directories

You should check this box to search for all of the matching files in the directories below the search directory.


AttribSystem
System

Checking this box will make all of the selected files system files.


Background
Background Settings

This dialog lets you configure the background window that is displayed during the installation.  You can set the color, gradient, and size of the background window.


Background256
Background Uses 256 Colors

The background gradient colors normally use the default 16 colors Windows provides. You can check this box for the background to use 96 palette entries to display the background gradient on computers that support this. You should not use this option when placing 256 color bitmaps on the background. The background gradient will appear distorted if your 256 color graphic has more than 120 unique colors in it.


BackProc
Background Processing

If this box is checked your system will be able to process background tasks during the compile process. This will slow down the compile process by 50%. If this box is not checked Windows will not respond to user input during the compile.


BoldFont
Font Weight

Normally, all messages and dialog boxes use a bold font to display text. Windows 95 now uses non-bold fonts at the default. You can use these radio buttons to select whether the fonts displayed will be bold or light in message and dialog boxes.


Browse
Browse Button

Pressing this button will allow you to browse the files and directories on your disks to select the proper source files and directories.  If you are not sure what the file and/or directory names are, press this button.


Cancel
Cancel Button

This button cancels the changes you are about to make.  Any changes that you have made to THIS dialog box will be gone when you press this button.


CenterDialogs
Center Dialogs Over Progress Dialog

If you check this box, all dialogs and message boxes will be centered of the same part of the screen as the progress dialog. This is useful if you do not want any graphics located on one portion of the background to be covered during the installation.


CenterHorz
Center Horizontal

Checking this button will cause the graphic image to be centered on the screen left to right.


CenterVert
Center Vertical

This button, when checked, will cause the graphic to be displayed centered on the screen vertically.


CheckFreeSpace
Check Disk Free Space

This checkbox controls when the amount of free space on the disk drive selected in the prompt will be checked.  If the total size of the files on the installation is larger than the amount of free space on the destination drive, an error will be reported.  This disk space check does not take components or mulitple destination directories into account.  You should use the Check Disk Space advanced script item for advanced disk space checking.


ChkComp
Component Variable

If you are performing a component based installation, place the component variable into this field.  The disk space check will only check the files will be installed based on the components selected by the user.  The component script item must appear before the check disk space item.


ChkExists
Exists

This list selects whether the action is performed if the file exists or does not exist on the destination computer.


ChkPathName
File Pathname to Check

This field holds the pathname on the destination computer to search for.  The pathname should begin with a variable.  No wildcard characters are allowed in the file pathname.


ChkSpace
Extra Space

You should enter the amount of K bytes that should be free after the installation of your software on the given disk.


ChkVar
Extra Space Variables

You can add up to three variables that extra space must be available at the end of the installation.  This will ensure that space is available for printing, temporary files, or save files.


Clear
Clear Button

This button will delete all script items.  Use this button with care!


ColorNums
Starting and Ending Colors

You can set the starting color (at the top of the screen) and ending color (at the bottom of the screen) on the background screen.  The numbers you place in the boxes indicate the amount of red, green, or blue in the background.  The numbers in each box can range from -255 to 512.  The small the number the less of that color will appear, the larger the color the more will appear.


ColorPick
Pick Color

This button will display a dialog that will allow you to graphically choose a color for the background starting or ending color.


Compression
Maximum Compression

This selects a higher compression ratio for files that are being placed into the installation executable.  If you check this box, it will take longer to create the installation executable.  The resulting installation executable will be slightly smaller.


ConfirmExists
Confirm If Directory Already Exists

If you check this checkbox and the installer specifies a directory that already exists, they will be prompted if they want to continue.  If they answer no, they will be returned to the prompt dialog.


ConfirmText
Confirmation Text

This field contains the text that will be displayed to confirm the users choices.  If this field is blank, no confirmation is done.


CopyNotExist
Preserve Existing Files

Checking this box will cause the file to be installed only if a file with the same pathname does not already exist on the destination system.


CurrLanguage
Current Language

This field holds the current language that you are working on.  When you change this field, all of the script items will change to reflect that language.  If you are creating a multi-lingual script, modify the installer messages by selecting the Languages item from the View menu.


DateTimeCheck
Date Time Checking

If this box is checked, the file will be installed only if it is newer than an existing file on the destination computer.


DDE Support

The Wise Installation System allows you to control the installation process from a program (such as a Visual Basic program).  This can be useful if you do not want to write DLL functions to customize the installation.  The DDESAMP installation script demonstrates the use of a Visual Basic program that reads the values of variables and creates new variables during the installation.  The source code to the Visual Basic program is in the DDE subdirectory below the WISE main directory.

NOTE:  This feature is only available in the Wise Professional Version.


DefaultDir
Default Directory

This is the directory that the program will be placed in when it is first executed.  If this field is left blank, the default directory will be the directory where the program is located.


Delete
Delete Button

This button will delete the currently selected script item.  You should select a script item by clicking on it in the list to the left.


Delete Group

This button can be used to delete an entire Program Manager group.  You should fill in the group name to the right.


Delete Item

You can select this button to delete an icon from a Windows Program Manager group.  You should fill in the group name and the icon name to the right.


DelPathName
Delete File Pathname

This field holds the pathname on the destination system of the file to delete.  You may want to delete installation DLLs after you have used them.


DestinationDisk
Destination Disk Drive

This list selects which floppy disk drive the installation executable will be copied to.


DiskFileName
Filename on Floppy Disk

This field holds the name that you want your installation executable to be called on the floppy disk.  If this field is blank, the file will have the same name as the installation script.  Common names for this field are INSTALL and SETUP.


Disk Label

This field holds the volume label for the disks that you are creating.  The label should be up to 11 characters long and contain valid file name characters.  You can include a %d in your label to include the disk number.  If you want a two digit disk number you should include %02d as in the example:

     INSTALL #%02d

This would label the first disk "INSTALL #01", the second "INSTALL #02", etc.


DLLExit
Exit If Function Returns True

The DLL function returns a boolean value (true or false).  If you select this button, the installation program will exit if the DLL function returns a TRUE.


DLL Function Name

This is the name of the function within the DLL to call.  The function should be exported to be called.  It must also match the parameters and return value specified exactly.


DllHide
Hide Copy Dialog During DLL Install

Checking this box will cause the "Installing" dialog box to not be displayed while the DLL is being installed onto the system.  This checkbox may be used on DLLs that are copied at the beginning of the installation.


DLLIgnore
Ignore Return Value

The DLL function returns a boolean (true or false) value.  If you select this button the value will be ignored by the installation program.


DLLParameter
Parameter String

You can pass a string to your function with this field.  For example, you way want to pass a pathname of the file you want the DLL function to operate on.


DLL Pathname

You should enter the pathname of the DLL to call.  This pathname should be specified for the destination system.  The DLL should have already be copied to the destination system.


Topic1
Start Block If Return Value True

The DLL Function can return TRUE (non-zero) or FALSE (zero).  If it returns FALSE, all script items will be ignored until the matching End Message Block is found.


DLLVarsAdded
Variables Added

Since the DLL function has access to the variable list of the running installation program, you may decide to have it add new variables.  List the names of the variables you will add separated by commas.


DoLoopOnce
Do Loop At Least Once

Normally the While Loop checks the condition first before the loop is executed. If you check this box, the first check will not be performed. This will be guarantee that the script items in the block will executed at least once.


Drag and Drop
Drag and Drop Support

You can use Drag and Drop to quickly add many files and directories to your installation script.  To use Drag and Drop, do the following:

•	Minimize the Wise Installation System so that it is an icon at the bottom of the screen.

•	Select the files and/or directories that you would like to add to your installation script in the File Manager.  You should use the Shift-Click and Ctrl-Click combinations to select as many files/directories as desired.

•	Click and hold one of the selected files and drag it until the mouse of over the icon of the Wise Installation System.  Release the mouse button.

•	Fill in the Drag and Drop dialog box.  The destination field should contain the directory name (without a file name or trailing backslash) where the files will be installed on the destination system.


Duplicate
Duplicate Button

This button will duplicate the currently selected script item.  The new item will be added directly below the selected item.


Edit
Edit Button

Press this button to edit the values in an existing script item.  Select the script item from the list to the left first.  You can also double-click the script item to edit it.


Else Block

This script item ends the current block and starts an else block.  The script items in this block will be executed if the matching start block was false.


Embed3d
3D Effects

This checkbox controls whether the installation will embed the CTL3D.DLL into the installation executable.  This will add about 11K bytes to the size of the installation.  Checking this box will guarantee that the dialog boxes will have a 3D effect.  It also allows you to update the CTL3D.DLL on the destination computer without getting a sharing error.


EraseAll
Erase All Graphics

If this button is checked all previous graphics that were displayed will be erased from the screen.


EraseDisk
Erase Destination Disk

If this checkbox is selected, all files that are on the floppy will be deleted before the installation file is copied to the disk.


ErasePrev
Erase Previous

This button will cause the last graphic that was drawn to be erased and replaced with this graphic.


Exclude List

This list contains the DLLs and VBXs that you do not want to be included in the dependency checking.  For example, since VBRUN300.DLL is commonly downloaded separately, you would include that file in this list.  All DLL files should have the .DLL extension (ex: VBRUN300.DLL) and all VBX files should have the .VBX extension (ex: THREED.VBX).


ExecCommand
Command Line

Enter the command line for the program you will execute.  This field is optional.


ExecDefault
Default Directory

You may place the default directory for the program into this field.  This field may contain variables.


ExecMaximize
Maximize Window

If this box is checked, the window for the executed program will take up the entire screen.  This is useful if you want to execute Notepad or Write at the end of an installation.


ExecPathName
Program Path

Enter the pathname of the program on the destination system that you want to execute.  If you leave this field blank, the file extension on the command line will be used to determine the program to execute on the destination system.


ExecVars
Variables Added By Program

A program can query and modify variables via DDE during the installation.  You should add all of the variables that this program will add to this field.


ExecWait
Wait for Program to Finish

This checkbox controls whether the installation waits for the program to complete before continuing.  You can use this checkbox to allow external programs (via a DDE link) to control the installation process.


Fade In

Check this box to have the graphic slowly fade in as it is being displayed. This option does not work with transparent bitmaps.


Fast Create

This option speeds up the installation creation process by copying the compressed version of a file from the previous installation executable to the new one.  If the size or date of a file has changed, it will be re-compressed.


File Description

This field holds the description that will be displayed while the file is being copied.


FileDestination
Destination

Enter the pathname of the file on the destination system.  This pathname must begin with a variable name.  This allows the installer to determine where all of the files will be installed on their system.  The variable names must be enclosed in percent signs (example:  %MYDIR%).  There are three pre-defined variables, WIN (the Windows directory), SYS (the Windows System directory), and TEMP (the Windows temporary directory).

For example:  if you have prompted for the destination directory and given the prompt the variable name DESTDIR a valid pathname would be %DESTDIR%\MYFILE.EXT


FileSource
Source

Enter the full pathname of the source file into this field.  You can use the browse button to locate a file.


FindFileExt
Find File Extensions

This field holds the wildcards used in the Find Files and Script Assistant program files selection.  You should edit this list to contain those extensions that make up your program files (*.VBX, *.DLL, etc.).


GlobalProp
Global Properties

These options effect the way the installation script runs. The options in the developers section are only valid in the Developers version of Wise. You can click to on the dialog box below to get more detailed information on the global properties.


GraphPathName
Graphic Pathname

This is the full pathname of the graphic file on your machine.  This file must be a Windows Paintbrush BMP file.  It should be 16 colors or less.


Group Name

This is the name of the Program Manager group that you want to effect.


HideProgMan
Hide Program Manager

If this box is checked, the Program Manager will not appear as icons are added or deleted.


HideProgress
No Progress Bar

Checking this box will cause the progress dialog box to be hidden as the file is being installed to the system. This can be useful for small temporary files that will be installed (install DLLs, temporary readme files, etc.)


Icon Number

If your executable file has more than one icon in it, you can select the icon number in the executable file with this field.


Icon Path

This is the pathname of the icon file to use for display.  If this is blank, the icon is pulled from the file itself.


If Compare

The type of comparison to make is listed in this field.  The contains comparison can be useful when used with a radio dialog or a component dialog.


If Value

The value to compare against the variable.  This value is case sensitive, that is the value 'a' is different that the value 'A'.


If Variable

This field holds the name of the variable to check.  This variable must have been previously created.


IncludeSubDir
Include Sub-Directories

Checking this box will cause all matching files in all of the directories below the directory you specified to be scanned as well.


IncludeSubDirs
Include Sub-Directories

Checking this box will cause the installation to scan all of the directories below the directory you specify for matching files.


INIFile
INI Filename

Enter the name of the INI file you want to edit.  If you leave this field blank, the WIN.INI file will be edited.  You can use variables to prefix the filename if you want to edit INI files in program directories.


INI Section

This field holds the name of the section to edit.  This field is required.


INISettings
INI Item Lines

You place items into this list to edit the INI file.  If you leave this field blank, the entire section will be deleted.  If you specify a line with an equal sign at the end but no value, that item will be deleted from the section.  New items can be added by entering:

     ItemName=ValueStr

You can use variable names in the item lines.


Insert
Insert Before

When this box is checked, the new script item that you all will be inserted before the currently select script item.  If this box is not checked, the item will be added after the current item.


InstallLogPath
Install Log Pathname

Normally the INSTALL.LOG file is placed into the first directory that files are copied to. You can place the full pathname (including the filename) of the INSTALL.LOG into this field to place the INSTALL.LOG into another directory. The directory must exist for the INSTALL.LOG to be placed into that directory. You should create the directory before you install any files to the destination computer.


InstallPassword
Installation Password

The installation password can be used to protect part or all of your installations from being installed without the user entering the proper password. If you prompt the user for the password from the installation you must place the password into the variable PASSWORD. If the PASSWORD variable is blank or incorrect the installation will prompt the user for a proper password when a file that requires a password is first encountered.


ItemName
Icon Name

This is the name of the icon that you are adding or deleting.  If the icon already exists in the Program Manager group you have specified, it will be updated with the new information.


LangCopyDefault
Copy Default Language

This checkbox controls whether the text of the default language will be copied to all other languages in your script items.  This can be useful when translating from one language to the next.  For example, if you set english as your default language (in the far left column), the english text you enter would be copied to any other languages you define in your script.  After you have translated the english to another language, you would delete the english text.


LangDefault
Default Language

This column defines which of the languages is the default.  The default language can be copied to any other with the Copy Default checkbox.


LangDialog
Language Dialog Text

This field holds the text that is displayed in the language dialog that is initially displayed.  You should instruct the user that they should select the proper language from the list below (you may want to repeat the destription in a few different languages).


LangEXEOrder
EXE Language Order

This column controls which of the languages in the installation script will be written into the installation executable.  If you know which language your client speaks, you may want to create an installation executable with only that language in it.  The number appearing next to the checkbox defines the order that the languages will appear to the person running the installation executable.


LangMsg
Langage Messages

This list holds all of the messages that can be displayed during the installation.  You should select an item from this list to change its value.


LangName
Language Name

This list holds the names of all of the languages that Wise supports.  These languages will be detected on the destination computer.  Select a language from this list to edit the messages for that language.


LangText
Language Message Text

This field holds the actual text of the message that will be displayed on the destination computer.


LangTitle
Language Dialog Title

This field holds the title of the dialog box that will be displayed when the installation initially starts.  This dialog will let the user choose which language the installation should use.


LangTrans
Language Translated Name

This field holds the name of the language translated into the language itself.  This value will appear in the list of languages that can be selected when the installation starts.


Languages
Languages Overview

Wise supports multiple languages in a single installation script.  When the installation executable is first run, the user is prompted for the language they would like the installation to be in.  There are two steps required in creating a multi-lingual installation executable:

1 	Create language specific messages for the installation by selecting the Languages menu and Installation Message menu item.  You will need to translate all of the messages that may appear during this installation.

2 	Define which of the 15 languages you would like you installation script to use.  To do this, select the Languages Menu and Scipt Languages item.

3 	Create the language specific messages for an installation script by changing the Current Language list on the main screen.


Languages Dialog

This dialog box edits the messages that may be displayed during the installation.  You may customize the messages or translate them into different languages.  You may use the ampersand character (&) with the OK and Cancel button texts. You can modify the messages that installations will display by selecting a language (from the Language Name list) and a message (from the Messages list) and editing the text in the Message Text field.

The Dialog Title and Dialog Text fields are used when an installation includes more than one language. These fields will be displayed to allow the user to select which language to run the installation in.


LangUsed
Languages Used

This column selects which of the 15 available languages your installation script will use.  Each language you select must have been translated in the Installation Messages dialog.


Local Path

Wise needs to create a list of the files that will be copied and their sizes. This field holds the pathname or wildcards of the files on your computer that will be copied. If you leave this field blank, you can only copy single files and the progress bar will not be updated as the file is being copied (the size of the file will not be known until install time). If you place a directory name of use wildcards in this field, the Source and Destination fields should contain directory names.


LongFileNames
Support Long Filenames

The Windows NT and Windows 95 operating systems support long filenames. You can check this box for your installation to support creating files and directories that have long filenames. You must ensure that your program can handle the long filenames that may be entered by the user before selecting this option.


MinBuffers
Minimum Buffers

You should enter the smallest number of buffers your program will run with.  If the number of buffers in the CONFIG.SYS is lower that this number, it will be increased to this number.  You may leave this field blank to leave the number of buffers unchanged.


MinFiles
Minimum Files

You can set the minimum files in the CONFIG.SYS with this box.  If you leave the box empty the Files= line will not be changed.


MsgAsterick
Asterisk Icon

An icon of an asterisk will be displayed in the upper left hand corner of the message dialog box.


MsgBlock
Start Block

If this box is checked the message will not display OK and Cancel buttons.  Instead it will display Yes, No, and Cancel.  If the user enters No, all script items between this item and the matching End Message Block item will be ignored.

You can use this feature to implement conditional installation of components of your software.  Message blocks can be nested within each other.


MsgExclamation
Exclamation Mark Icon

An icon of an exclamation mark will be displayed in the upper left hand corner of the message dialog box.


MsgNone
No Icon

Selecting this radio button will display the message without any icon at the upper left corner.


MsgQuestion
Question Mark Icon

An icon of a question mark will be displayed in the upper left hand corner of the message dialog box.


MsgStop
Stop Sign Icon

An icon of a stop sign will be displayed in the upper left hand corner of the message dialog box.


MsgText
Message Text

This is the actual text that will be displayed on the screen.  You can use the Ctrl-Enter key combination to put blank lines in the message box.  You can use variable names in your message text.


MsgTitle
Message Title

This will appear in the window title of the message that is displayed on the screen.


Network and CDROM Installations
Network and CD-ROM Installations

In network and CD-ROM installations uncompressed files are copied from a network server disk or a CD-ROM onto a users computer.  The files should be copied with the Local File Copy checkbox on the file script item.  The source field should contain the location of the file to copy on the destination computer.  The %INST% variable holds the pathname of the installation executable.  This variable can be used to locate the files to copy.


NoAppend
Don't Append Directory Name

Normally, the default directory name is appended to the end of the default directory is the directory name field.  This checkbox will suppress this feature.  This can be useful if you want the user to select an existing directory.


NoCancel
No Cancel Button

If this box is checked, the message will not have a Cancel button in it.


NoInstallLog
No Installation Log

Checking this box will cause no installation log file to be created.  This can be useful if you are copying files only to the Windows, System, or Temporary directories.  You cannot use the Wise Uninstaller if you check this box.


NoVersionError
Suppress Version Error

This option will allow you to check the Version Check option in the install file script item on files that do not have version resources. When a file is detected without a version resource version checking is suppressed an no error is generated.


OClientComputer
Clients Computer

This is the computer that will receive the copy of the software that you are distributing.


ODestination
Destination File

These files are copies of the ones that are on your computer.  They are created on your clients computer by the installation executable.


ODistribution
Floppy or BBS Distribution

The installation executable must be delivered to your client for them to execute it.  You can place it on a BBS or other on-line service.  You can also mail it to them on any type of floppy disk or CD-ROM.


OExecutable
Installation Executable

The installation executable is a Windows EXE file (located in the same directory as your installation script) that contains all of the files and instructions from the installation script.  This file is uploaded to a BBS or placed on a floppy and mailed to your client (the installer).


OK
OK Button

Press this button when you are done with this dialog box.  This button will save the changes that you have made to this dialog.


ORun
Run Installation Executable

Your client runs the installation executable on their computer.  They usually select the Run item from the File menu in the Program Manager.  They then type the name of your installation executable and press the OK button.


OSourceFile
Source File

These are the files that comprise your program.  The are usually the EXE, VBX, DLL, HLP, and other support files that are located on the programmer's computer.


OWise
Wise Installation System

The Wise Installation System reads the files that are given in the installation script and creates an installation executable.


OYourComputer
Your Computer

The is the computer where the program that is to be distributed has been written.  It holds the program and all of its support files.


Placement
Copy Window Placement

This list selects where the copy dialog box will appear during the installation.  If you want to place graphics on the screen during the installation, you can move the box to another part of the screen.


PMCommandLine
Command Line

This is the command line to execute when the icon is double-clicked in the Program Manager.  You should use a variable name to select where the program is located.  For example: %DESTDIR%\MYPROG.EXE


PostConfirm
Confirm Dialog

This checkbox will cause the user to be prompted if they want to add the icons to the Program Manager.  Otherwise, the icons will be added automatically.


PostFiles
Files to Add Icons For

You should select those files from this list to add icons to the Program Manager.


PostGroup
Default Group Name

This group name will be the default that is placed into the prompt that is displayed to the user.


PostScr
Post Installation Settings

This dialog controls which icons will be placed into the Program Manager at the end of the installation.


PreBackup
Backup Replaced Files

You can check this box if you want to ask the user if the files replaced files during the installation should be backed up.


PreBranding
Branding

This checkbox controls whether the user is asked for their name and a company name during the installation.  The name and company will be stored on the floppy disk the software was installed from.


PreBrowse
Browse for ReadMe Path

Press this button to locate a text file to display as your read me file.


PreComponents
Software Components

This text box contains a list of the components of your software.  If your software will be installed as a single component, leave this field blank.  Each line should contain a label for the components.  You will be prompted for the files that are associated with each component.


PreDefault
Default Directory

This directory is the default that the user will be prompted with during the installation.  It should be a top level directory, normally located on the C drive.


PreOLE
OLE 2

This checkbox will copy the OLE 2 files onto the destination computer.  You must have a working copy of OLE 2 on your computer to check this box.


PreReadMe
ReadMe PathName

If you want to display a read me file before the installation begins, place the pathname of a text file into this field.


PreShare
File Sharing via Share

This checkbox will cause file sharing to be installed onto the destination computer system.  The file VSHARE.386 will be installed if share is not already installed.


PreTitle
Software Title

This field holds the title of your software package.  An example of a software title is "Wise Installation System".  This title will be displayed in messages and in the title bar during the installation.


PreUninstall
Uninstall

You should check this box if you want the Wise Uninstall program to be copied to the destination computer.  An icon will be added that will allow the user to remove the software from their computer.


ProgressScript
Progress Bar is Script Based

Normally, the progress bar is based on the percentage of files that have been extracted from the installation exectable.  If you are creating an installation executable that does many local file copies (i.e. Network or CD-ROM installations) you should check this box.  The progress bar will then be based on the percentage of script items that have been executed.


PromptDefault
Prompt Default Value

If you place a value in this field, it will be pre-filled in when the prompt is displayed.


PromptDescr
Prompt Description

The text entered into this field give the installer information about what they should enter into the prompt.


PromptDir
Directory Name

If this box is checked, any trailing backslashes will be deleted from the string that the user enters in the prompt.  This is useful when prompting for a destination directory name.


PromptTitle
Prompt Name

This should contain a description of the information you are asking for.  For example, if you want to ask for the directory to install you program, you should enter:  Enter Directory to Install My Program:

NOTE:  You should end the title with a ":" colon.


Prompt To Save

If this checkbox is checked you will be prompted if you want to save your installation script each time you create a new installation executable. If this box is not checked the installation script will be automatically saved for you each time you create a new installation EXE.


PromptVar
Prompt Variable Name

This is the name that you will refer to this prompt as in your other script items.  This must not contain a percent sign (%).  It should be no longer than 14 characters.


PromptWin
Prompt Window Name

This field holds the name of the window that the prompt will appear in.  An example of a prompt window name would be: Select Destination Directory


Read Environment Variable

This field holds the name of the environment variable to read.  For example, COMSPEC, PATH, and PROMPT are all valid environment variables.  This field is case sensitive (for Windows NT).


RegDataType
Registry Data Type

Each key in the Win32 registry can have different possible types. Windows 95 supports String and Double Word types. Windows NT supports all possible data types while Win16 only supports the String data type. If you use the Double Word data type you must enter the number as a decimal integer into the value field.


RegKey
Registration Database Key Name

This holds the name of the key in the registration database to add.  It is added directly below the root specified by the Root radio buttons. An example of a valid key name is:

     NewAppDocument\protocol\StdFileEditing


RegRoot
Win32 Registry Root

The Win32 registry consists of a set of keys, arranged hierarchically, all beginning at the root key. The four possible root keys are: HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_CURRENT_USER, and HKEY_CLASSES_ROOT. You must use the HKEY_CLASSES_ROOT root to add an entry to the Win16 registration database.


RegValue
Registration Database Key Value

This field holds the value of the key you are adding.  You can use variable names in this field. If the data type is Multiple Strings, you can enter a list of values, one per line, into this field. For all other data types you must enter only a single line of information.


RegValueName
Registry Value Name

The Win32 registry allows multple values to be placed into a single registry key. This field holds the name of the value to be placed into the key. The Win16 registration database does not support value names.


RemComment
Remark Comment

The comment you would like to place into your installation script should be entered into this field.


RemoveDir
Remove Directory Containing Files

This option will remove any directories that contain matching files. The directory must be empty (i.e. you must have deleted all of the files in ti) for this option to work.


Require Password

If this box is checked the user will be prompted for a password before this file is installed. The password will be prompted for only once during the installation. You can use this option to select certain files that can be installed without a password (i.e. demo files). The option will not be displayed if your installation does not have a password.


RunManual
Run in Manual Mode

The installations created by Wise support a manual mode that allows you to select where to place files that will normally be copied to the Windows, System, or installation directories. If you check this box, you will be prompted to select the locations of these directory each time you run your installation from inside of Wise.


Run Minimized

This checkbox will cause the program to be run as an icon when the user double-clicks on it in the Program Manager.


Scale To Screen

Windows supports many different screen resolutions.  If you check this checkbox, the graphic image will be scaled to be the same size at any screen resolution.


ScanDLL
Scan EXE Header

Checking this box will cause all executable files (EXE, DLL, VBX) to be scanned for the DLL files that they use.  This will slow down the create processes somewhat.  The list of DLLs will be checked against the files that you have included in your installation script.  Any DLLs that are referenced but not included will be displayed after the installation executable is created.

NOTE:  The EXE header is scanned for import references. Any DLLs that are loaded dynamically (i.e. with LoadModule) will not be detected.


ScanVBX
Scan Entire EXE File

Checking this box will cause all EXE files to be scanned for the VBXs/DLLs files that they use.  This will slow down the create process somewhat.  The list of VBXs/DLLs that are referenced will be checked against the files that you have included in your installation script.  Any VBXs that are referenced but not included will be displayed after the installation executable is created.

NOTE:  Since VBX files can be loaded dynamically, there are cases where a VBX reference may not be detected.  There is also the possibility that extra references will be reported.


ScrAddDir
Add All Files in Directory

This button will add all of the selected files in the file names listbox to your installation script.  No files in sub-directories will be added.


ScrAddFile
Add File

Press this button to add the currently selected file in the File Name list to your installation script.  The file will be added to the list to the left.


ScrAddMake
Add Makefile

Press this button to add all of the files in a Visual Basic makefile into your installation script.  Only Visual Basic makefiles are currently supported.


ScrAddTree
Add Directory Sub-Tree Files

Pressing this button will add all of the selected files for the current directory and all sub-directories below it.


ScrDelete
Delete

Press this button to delete the currently selected file in the "Files Added to Installation Script" list.


ScrDest
Destination Directory

This directory variable will be used to select the destination of the installed files.


ScrDir
Directory

This is allows you to select the directory where the files to install are located.


ScrDrives
Drives

This list select which of your disk drives to locate the files to place into the installation script.


ScrFiles
Files Added to Installation Script

This list contains all of the files that will be added to the installation script.  The buttons to the right control the adding and deleting of files from this list.


Script
This list box will hold your installation script items.  This script determines how your software will be installed when the Wise executable is run.  If you double-click on a item in this box, you can edit the information about that item.  The buttons to the right should be used to add, edit, and delete items from this list.


Script Actions

This list contains all of the possible actions that can be performed by Wise during the installation. You can add a new action to your installation script by double clicking on an item within this list or by dragging an action to the appropriate location in the installation script.


ScriptLanguage
Script Languages

The script languages dialog is used to determine the languages that your installation script can use.  It also defines which of the languages should be exported into the installation executable (and in which order). Select all of the languages to include in your installation from the list. The number to the right indicates the order the languages will be displayed to the user at the beginning of the installation. The Copy Default checkbox will copy all of the text from the default language to all of the other languages (to assist the translation).


ScrName
FileName

This list selects the files to add to your installation script.


ScrRunEXE
Run EXE

This button will execute the selected program and monitor the DLLs and VBXs that the program loads, adding them to the files to install. When you press this button you should test all of the features of your program to ensure that all DLL/VBXs are detected. When you are done, exit your program. This feature currently works with Win16 programs only.


ScrType
File Type

You can select which type of files to display in the files list.  The Program Files list can be customized in the View->Preferences dialog.


Select Files to Install

This dialog is used to select which files will be placed into the installation script.


SharedDLL
Win95 Shared DLL Counter

Windows 95 supports the shared DLL/VBXs by using a counter stored in the registry. Each time an application that uses the DLL attempts to install the file, the counter is incremented. When an application is un-installed this counter is decremented. If the counter returns to zero, the user is prompted to delete the file from their system. You should check this box on any DLL/VBX files that will be shared by more than one application.


Show TitleBar

You can check this box to display the title bar at the top of the installation screen.  If this box is not checked, no title will be displayed.


Smart Create

The smart create option will check the date time modified and size of all of the files in your installation to see if they have changed since the last time the installation executable was created.  If any of the files has changed, the installation executable will be re-created.  This option will add a small amount of time to the Run and Make Disk commands.


SPDefault
Default Value

This field holds the value that the variable will be set to if the file is not found in any of the search paths.


Speed
Control Install Speed

This checkbox controls whether the installation process is slowed on fast computers that run the installation executable from a hard disk.  This ensures that the installer will have enough time to read the graphics that you place on the screen.


SPFile
Filename

This field holds the name of the file to search for.  All of the directories in the PATH environment variable will be searched for this file.


Split
Split EXE

This selects how big a Wise executable can become before it is split into another file.  If this is left empty, the executable can be as large as necessary.  You would normally set this to be the size of the floppy disks that you ship your software on.  The split files will have the file extension W02, W03, etc.

NOTICE:  This feature is only available in the Wise Installation System Professional Version.  Please refer to the registration screen for more information.


SPVar
Variable Name

This variable will receive the full pathname for the file if it is found.  If the file does not exist in any of the directories searched, it will contain the default value.


Start If Block

Select this option if you want to script items in the enclosed block to be executed once if the If statement is true.


Start While Loop

Select this option to cause the enclosed script items to be executed repeatedly until the condition is false.


StatusTips
Show Status Bar Tips

Checking this box will enable the status bar tips.  As you move the mouse over the tool bar buttons, a description of what each button does will appear in the status bar at the bottom of the window.


TileBk
Tile Graphic as Background

You should check this box to have the graphic used as a tiled background during the installation.  The graphic will be repeated for the entire size of the background window.


Title
Window Title

This holds the title of the installation script.  This will appear at the top of the window during the installation.

Example:  A common title would be "MyProgram Installation"


Tool Bar Icons

Below is the toolbar that is located directly below the Wise menu.  Click on one of the buttons for a description.


ToolAbout
About Wise

This button will bring up a dialog box describing the version of Wise you are running.


ToolComment
Comment Script Items

This button will "comment out" the selected script items.  Script items that are commented out are ignored by the Create, Test and Run commands.  Pressing this button again will uncomment the selected items if they are already commented out.


ToolCopy
Copy Script Item

This button will copy the currently selected script item into the clipboard.


ToolCut
Cut Script Item

This button will delete the currently selected script item and place it into the clipboard.


ToolDown
Move Script Item Down

Pressing this button will move the currently select script item down in the installation script.


ToolNew
New File

Pressing this button will clear your workspace so you can start a new installation script.  If you have made changes to your old installation script, you will be prompted to save your changes.


ToolOpen
Open Existing File

Press this button to open an installation script that you have already created.  You will be prompted for the pathname of the installation script.


ToolPaste
Paste Script Item

Pressing this button will insert the script item that is in the clipboard into the script before the currently selected script item.  If no script items are selected, it will be appended to the end of the script.


ToolPrint
Print Installation Script

This button, when pressed, will print your installation script to a printer.  You must have the Professional Version of Wise to print installation scripts.


ToolSave
Save Installation Script

Press this button to save your changes to the installation script.  If you have not saved it previously, you will be prompted for the name of this installation script.


ToolTips
Show Tool Bar Tips

Checking this box will enable the tool bar tips.  If you stop the mouse over a button in the toolbar, a small window will appear describing what that button does.


ToolUp
Move Script Item Up

Pressing this button will move the currently selected script item up by one.


Transparent
Transparent Graphic

This button allows you to place a graphic into the installation where parts of the background show thru.  Everywhere that you use the solid blue color (Red=0, Green=0, Blue=255) will become transparent to the background and to each other.


TreeDescr
Tree Description

This field holds the description that will be displayed while the files are being copied.


TreeDst
Tree Destination

This is the name of the directory where the files will be placed.  This should start with a variable name.


TreeSrc
Tree Source

This is the pathname of the directory tree that you want to place into your installation executable.  You can use the browse button to select the tree.


Version Check

You should use this checkbox to install DLLs or VBXs that contain a version resource.  A good example of files to use version checking on are CTL3D.DLL and THREED.VBX.  You may use version checking for files that are not to be installed into the Windows System directory (i.e. application private files).  This check reads the version resource from each of the files and installs the file if it is newer than the existing file.


Window Preview

A small preview of the background window is displayed here.


WindowSize
Background Window Size

These three radio buttons determine the size of the background window.  You can make the background window the size of the entire screen, most of the screen, or to not have a background window.


WriteMaxLength
Maximum Length to Write

This field holds the maximum number of bytes to write to the file from the variable.  A null byte (zero) is always written to the end of the data written.


XPos
X-Position

This determines where the graphic is placed in the installation window.  A larger value will move the graphic more to the right.


YPos
Y-Position

This value determine how high up in the window the graphic will appear.  A larger value will move the graphic down in the window.


ZipDirectory
Zip Compatible Directory

You can check this box to make your installation executable compatible with programs that read the standard ZIP file format. This is useful when uploading a file to a public on-line service or BBS system. Your file can be scanned for viruses automatically by the on-line service or BBS operator. If you make your installation ZIP compatible, you cannot place a password on it or split the EXE across multiple floppies.


Installation Executable

The Windows self-installating executable that is created by the Wise Installation System.


Shareware

Shareware software allows you to try a software package for a limited time (in this case 30 days) before you decide to purchase it.  If you find that you want to continue using this software you can purchase a registered copy.


WISE

W.I.S.E. stands for WIndows Self-Installing Exectable.  This is a program that contains compressed copies of software and the installation script.